home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / src / exampleCode / opengl / x+opengl / README < prev    next >
Text File  |  1996-11-11  |  6KB  |  113 lines
  1.  
  2.                 Source for "OpenGL & X", X Journal Articles
  3.  
  4. ----------------------------------------------------------------------------
  5.  
  6. This directory contains source code from a three-part series of articles
  7. published in The X Journal about programming OpenGL and X.  Included in 
  8. each article is a complete program that is also reproduced here in 
  9. compilable form. This source can be found in the 
  10. sgigate.sgi.com:~ftp/pub/opengl/xjournal subtree.
  11.  
  12. The documents linked into this page hail from the documents/OpenGL directory
  13. -- if you wish to download more than one of the PostScript files at the same
  14. time, you'll need to go to that directory to "make it so". The Makefile for
  15. the following programs indicates what libraries are needed for each.
  16.  
  17.    * OpenGL(tm) and X, Part 1: An Introduction, Mark Kilgard, The X Journal,
  18.      November/December, 1993.
  19.         o compressed PostScript format
  20.         o uncompressed PostScript
  21.         o html
  22.  
  23.      The OpenGL graphics system is a high-performance, window system
  24.      independent 2D and 3D graphics interface. The technology was developed
  25.      by Silicon Graphics and is now controlled by the OpenGL Architecture
  26.      Review Board. OpenGL's GLX extension integrates OpenGL with the X
  27.      Window System. This article describes OpenGL's functionality and how it
  28.      is used with X. A simple OpenGL program using Xlib is presented. OpenGL
  29.      is compared and contrasted with PEX, a 3D graphics interface designed
  30.      specifically for X. The two subsequent articles in this series describe
  31.      how to integrate OpenGL with Xlib and Motif programs.
  32.  
  33.      glxsimple.c  A very simple OpenGL program rendering a cube which
  34.                   can be rotated using buttons presses.  The program
  35.                   demonstrates creating a window for use with OpenGL,
  36.                   hidden surface removal, and double buffering.  This
  37.                   program is presented in the first article in the
  38.                   November/December issue.
  39.  
  40.  
  41.    * OpenGL(tm) and X, Part 2: Using OpenGL with Xlib, Mark Kilgard, The X
  42.      Journal, January/February, 1994.
  43.         o compressed PostScript format
  44.         o uncompressed PostScript
  45.         o html
  46.  
  47.      This is the second article in a three-part series about using the
  48.      OpenGL(tm) graphics system and the X Window System. A moderately
  49.      complex OpenGL program for X is presented. Depth Buffering, back-face
  50.      culling, lighting, display list modeling, polygon tessellation, double
  51.      buffering, and shading are all demonstrated. The program adheres to
  52.      proper X conventions for colormap sharing, window manager
  53.      communication, command line argument processing, and event processing.
  54.      After the example, advanced X and OpenGL issues are discussed including
  55.      minimizing colormap flashing, handling overlays, using fonts, and
  56.      performing animation. The last article in this series discussess
  57.      integrating OpenGL with the Motif toolkit.
  58.  
  59.      glxdino.c    A moderately complex OpenGL program that renders a 3D
  60.                   dinosaur which can be rotated with mouse input.  The
  61.                   program demonstrates colormap sharing, proper set up
  62.                   of X window manager properties, maintaining window
  63.                   aspect ratios, back-face culling, double buffering,
  64.                   display list modeling, polygon tesselation, hidden
  65.                   surface removal, shading, lighting, and X event
  66.                   processing.  This program is presented in the second
  67.                   article in the January/February issue.
  68.  
  69.    * OpenGL(tm) and X, Part 3: Integrating OpenGL with Motif, Mark Kilgard,
  70.      he X Journal, July/August, 1994.
  71.         o compressed PostScript format
  72.         o uncompressed PostScript
  73.         o html
  74.  
  75.      The OpenGL(tm) graphics system can be integrated with the
  76.      industry-standard OSF/Motif user interface. This article discusses how
  77.      to use OpenGL within a Motif application program. There are two
  78.      approaches to using OpenGL with Motif. One is to render into a standard
  79.      Motif drawing area widget, but this requires each application window to
  80.      use a single visual for its window hierarchy. A better approach is to
  81.      use the special OpenGL drawing area widget allowing windows used for
  82.      OpenGL rendering to pick freely an appropriate visual without affecting
  83.      the visual choice for other widgets. An example program demonstrates
  84.      both approaches. The X Toolkit's work procedure mechanism animates the
  85.      example's 3D paper airplanes. Handling OpenGL errors is also explained.
  86.  
  87.      paperplane.c  A toy Motif program which draws 3D paperplanes
  88.                    flying in figure-eights on a sky background.  The
  89.                    program demonstrates both how to use the OpenGL-
  90.                    specific Motif widget and how to use the standard
  91.                    Motif drawing area widget.  Motif pull down menus to
  92.                    implement the GUI controls for the program.  Work
  93.                    procs handle the animal.  This program is presented in
  94.                    the third article in the July/August issue.
  95.  
  96. ----------------------------------------------------------------------------
  97.  
  98.      glxmotif.c   A program demonstrating how to use OpenGL with Motif
  99.                   (not using a special OpenGL widget).  Work procs are
  100.                   used for animation.  Press "s" to stop and start
  101.                   spinning the polygons; the arrow keys rotate the scene
  102.                   manually.  This program is presented in the third
  103.                   article in the March/April issue.  This program does
  104.                   not appear in any of the three articles, but appeared
  105.                   on the last Toolbox and appears here for completeness.
  106.  
  107.  
  108.  
  109. These programs will operate on an IRIS 4D machine running IRIX 5.1 or later.
  110.  
  111. ----------------------------------------------------------------------------
  112. Copyright ⌐ 1995, Silicon Graphics, Inc.
  113.